home *** CD-ROM | disk | FTP | other *** search
/ Workbench Design / WB Collection.iso / datatypes / font_dt / fontdt.guide (.txt) < prev    next >
Amigaguide Document  |  1996-04-07  |  15KB  |  327 lines
  1. @database FontDT
  2. @$VER: FontDT.guide 39.3 (8.7.95)
  3. @(C) Michael Letowski
  4. @author Michael Letowski
  5. @index Index
  6. @node Main "FontDT 1.1"
  7. @prev Main
  8. @next Main
  9.                                   @{b}@{u}FontDT 1.1@{uu}@{ub}
  10.              @{b}FontDT@{ub} package is Copyright 
  11.  1995 @{"Michael Letowski" link Author}.
  12.                              All rights reserved.
  13.       The author's native language is Polish, so please forgive bad spelling,
  14.   grammar mistakes etc. Or better - correct them.
  15.   @{"Copyright notice" link Copyright}
  16.   @{"  Introduction  " link Introduction}
  17.   @{"  Requirements  " link Requirements}
  18.   @{"  Installation  " link Installation}
  19.   @{"  Configuration " link Configuration}
  20.   @{"      Notes     " link Notes}
  21.   @{"     History    " link History}
  22.   @{"      To do     " link ToDo}
  23. @endnode
  24. @node Copyright "FontDT Copyright"
  25. @prev Copyright
  26.   @{b}@{u}Copyright@{uu}@{ub}
  27.   @{b}FontDT@{ub} package is Copyright 
  28.  1995 @{"Michael Letowski" link Author}.
  29.   @{b}FontDT@{ub} is freely distributable under the following conditions:
  30.  no more than a reasonable fee is charged for copying/downloading;
  31.  this distribution is not a part of other non-free distribution;
  32.  the distribution is complete - it contains all the files (full list
  33.       at the end of this chapter);
  34.  no file in the distribution is changed.
  35.       Distribution without meeting conditions specified above requires
  36.   written permission from me.
  37.       The @{"DataType" link DataTypes} from the package works, but no guarantee is given nor
  38.   implied. In no case will I be liable for any results of using supplied
  39.   @{"DataType" link DataTypes}.
  40.       The source code is provided only for informational purposes and is
  41.   also under copyright. It is based on source for @{i}bmp.datatype @{ui}by David
  42.   N. Junod.
  43.       This documentation is based on @{i}CatEdit.guide@{ui}, which is Copyright 
  44.   1993 Rafael D'Halleweyn.
  45.       Compugraphic, CG and Intellifont are registered trademarks of Agfa
  46.   Corp.
  47.   List of all files in the distribution:
  48.     @{i}Install FontDT.info
  49.     Install FontDT
  50.     FontDT.guide.info
  51.     FontDT.guide
  52.     Libs (dir)
  53.       DataTypes (dir)
  54.         font.datatype
  55.     Devs.info
  56.     Devs (dir)
  57.       DataTypes.info
  58.       DataTypes (dir)
  59.         Bitmap Font.info
  60.         Bitmap Font
  61.         Outline Font.info
  62.         Outline Font
  63.     Prefs (dir)
  64.       Env-Archive
  65.         DataTypes
  66.           font1.prefs
  67.           font2.prefs
  68.           font3.prefs
  69.           font4.prefs
  70.       Presets
  71.         def_font1.info
  72.         def_font2.info
  73.     Src (dir)
  74.       classbase.c
  75.       dispatch.c
  76.       otag.c
  77.       prefs.c@{ui}
  78. @endnode
  79. @node Introduction "Introduction to FontDT"
  80.   @{b}@{u}Introduction@{uu}@{ub}
  81.       @{b}FontDT@{ub} is a @{"DataTypes" link DataTypes} subclass for loading and viewing @{"Amiga fonts" link Fonts}.
  82.   Once installed it will let all @{"DataTypes" link DataTypes} aware programs to recognize and
  83.   load @{"Amiga fonts" link Fonts} as pictures.
  84. @endnode
  85. @node Requirements "Requirements for FontDT"
  86.   @{b}@{u}Requirements@{uu}@{ub}
  87.       @{b}FontDT@{ub} requires AmigaDOS 3.0 or higher (@{i}datatypes.library @{ui}and
  88.   @{i}diskfont.library @{ui}V39+). Outline fonts subsystem (@{i}bullet.library @{ui}V39+) is
  89.   required for accesing @{b}Compugraphic@{ub} fonts. 3rd party libraries are necessary
  90.   for viewing @{b}non-Compugraphic@{ub} outline fonts (eg. @{i}type1.library @{ui}by Amish S.
  91.   Dave for @{b}Adobe Type1@{ub} fonts).
  92. @endnode
  93. @node Installation "Installation of FontDT"
  94.   @{b}@{u}Installation@{uu}@{ub}
  95.       Use supplied @{i}Installer @{ui}script to copy necessary files. Activate
  96.   class by double-clicking on @{i}DEVS:DataTypes/Bitmap Font @{ui}and
  97.   @{i}DEVS:DataTypes/Outline Font @{ui}icon or use @{i}AddDataTypes @{b}REFRESH @{ub}@{ui}from Shell.
  98.       Please note, that neither sample config files nor icons will be
  99.   installed by the script (if you want to use them, you must copy them
  100.   manually).
  101. @endnode
  102. @node Configuration "Configuring operation of FontDT"
  103.   @{b}@{u}Configuration@{uu}@{ub}
  104.       You can use config files with @{b}FontDT@{ub} to customize appearance of
  105.   fonts on the screen. These files are @{i}PROGDIR:Prefs/DataTypes/font.prefs@{ui}
  106.   (@{i}PROGDIR: @{ui}is a standard system assign and denotes drawer where given
  107.   application resides) and @{i}ENV:DataTypes/font.prefs @{ui}(searched in that
  108.   order). Such setup seems to be standard across 3rd party @{"DataTypes" link DataTypes}.
  109.       Each config file should consist of one text line following standard
  110.   AmigaDOS rules for passing parameters.
  111. @{fg highlight}SYNOPSIS@{fg text}
  112.       [@{i}Strings@{ui}] [@{b}CENTER@{ub}] [@{b}INVERSE@{ub}] [@{b}FONTNAME@{ub}] [@{b}DPI@{ub}=@{i}DPI@{ui}]
  113.                 [@{b}FOREGROUND@{ub}=@{i}ForegroundColor@{ui}] [@{b}BACKGROUND@{ub}=@{i}BackgroundColor@{ui}] 
  114. @{fg highlight}TEMPLATE@{fg text}
  115.       "STRINGS/M,CENTER=CENTRE/S,INVERSE/S,FONTNAME/S,DPI/K,
  116.        FG=FOREGROUND/K,BG=BACKGROUND/K"
  117. @{fg highlight}PARAMETERS@{fg text}
  118.       @{i}Strings @{ui}- strings to display instead of default text. By default,
  119.   @{b}FontDT@{ub} will show a text consisting of all characters present in a given
  120.   font. You can change this by supplying your own strings which will be used
  121.   in place of this default string. Each string (separated by spaces) will be
  122.   displayed as one line. If you want your text to contain spaces, enclose it
  123.   in "".
  124.       @{b}CENTER@{ub} - this option causes each line to be centered before displaying.
  125.   Only useful if you have supplied more than one own string or are trying to
  126.   display font with more than one size.
  127.       @{b}INVERSE@{ub} - for two-colour fonts this causes @{b}FontDT@{ub} to swap foreground
  128.   and background colours. Does not work for colour fonts.
  129.       @{b}FONTNAME@{ub} - if this option is given a line containing font's name and
  130.   size will be printed before user strings.
  131.   @{b}FontDT@{ub} to use font's name and size to make default string.
  132.       @{b}DPI@{ub} - this strings describes font's acpect ratio. It should contain
  133.   values for XDPI and YDPI (as described in Workbench manual), in
  134.   "XDPI/N,YDPI/N" format. The whole string must be enclosed in double-quotes.
  135.   Default values for aspect ratio are DiskFont's defaults. At present this
  136.   option is only useful with outline fonts.
  137.       @{b}FOREGROUND@{ub} - describes foreground colour. The string should
  138.   contain amounts of red, green and blue, respectively. The template is
  139.   "R=RED/N,G=GREEN/N,B=BLUE/N". The whole string must be enclosed in
  140.   double-quotes. Default foreground color is black. This option doesn't
  141.   work for colour fonts.
  142.       @{b}BACKGROUND@{ub} - describes background colour. The string should
  143.   contain amounts of red, green and blue, respectively. The template is
  144.   "R=RED/N,G=GREEN/N,B=BLUE/N". The whole string must be enclosed in
  145.   double-quotes. Default background color is white. This option doesn't
  146.   work for colour fonts.
  147. @{fg highlight}EXAMPLES@{fg text}
  148.       @{fg fill}@{i}FontDT is great@{ui}@{fg text} will produce:
  149. @{bg highlight}FontDT
  150. great@{bg back}
  151.       @{fg fill}@{i}"FontDT is great"@{ui}@{fg text} will produce:
  152. @{bg highlight}FontDT is great@{bg back}
  153.       @{fg fill}@{i}"FontDT is" "great" @{ui}@{b}CENTER@{ub}@{fg text} will produce:
  154. @{bg highlight}FontDT is
  155.   great  @{bg back}
  156.       @{fg fill}@{i}"FontDT is" "great" @{ui}@{b}CENTER@{ub} @{b}INVERSE@{ub}@{fg text} will produce:
  157. @{fg highlight}@{bg text}FontDT is
  158.   great  @{fg text}@{bg back}
  159.       @{fg fill}@{b}FONTNAME@{ub}@{fg text} will produce:
  160. @{bg highlight}Times.font 12
  161. ABCDEFGHIJKLMNOPQ...
  162. Times.font 15
  163. ABCDEFGHIJKLMNOPQ...
  164. Times.font 18
  165. ABCDEFGHIJKLMNOPQ...@{bg back}
  166.       @{fg fill}@{i}"" @{ui}@{b}FONTNAME@{ub}@{fg text} will produce:
  167. @{bg highlight}Times.font 12
  168. Times.font 15
  169. Times.font 18@{bg back}
  170.       @{fg fill}@{i}"FontDT is great" @{ui}@{b}FONTNAME@{ub}@{fg text} will produce:
  171. @{bg highlight}Times.font 12
  172. FontDT is great
  173. Times.font 15
  174. FontDT is great
  175. Times.font 18
  176. FontDT is great@{bg back}
  177. @{fg highlight}SAMPLE CONFIGS@{fg text}
  178.       @{"Config 1" link Prefs/Env-Archive/DataTypes/font1.prefs/main}
  179.       @{"Config 2" link Prefs/Env-Archive/DataTypes/font2.prefs/main}
  180.       @{"Config 3" link Prefs/Env-Archive/DataTypes/font3.prefs/main}
  181.       @{"Config 4" link Prefs/Env-Archive/DataTypes/font4.prefs/main}
  182. @endnode
  183. @node Notes "FontDT Notes"
  184.   @{b}@{u}Notes@{uu}@{ub}
  185.       @{b}FontDT@{ub} shows all available sizes of a given font.
  186.       The font which you want to view must be somewhere in your @{i}FONTS:@{ui}
  187.   assign. I know this is not the best solution, but other implementation is
  188.   not possible without operating system conformance.
  189.       If you have bitmaps created for outline fonts, the DataType will only
  190.   show the sizes for which the bitmaps exist. Otherwise, it will try to show
  191.   all sizes specified with @{i}Intellifont @{ui}utility. If you have many
  192.   sizes (or don't have any) this will likely fail.
  193.       If you get "Out of memory" messages from your @{"DataTypes" link DataTypes} application,
  194.   then this is probably caused by too wide default string (which is made of
  195.   all available font characters). Use config files to change default string.
  196.   Choose shorter string or the one made of several lines.
  197.       For colour fonts with many sizes colour is set for biggest size.
  198.       You can use pictures produced by @{b}FontDT@{ub} as Workbench patterns, but
  199.   then only @{i}ENV:DataTypes/font.prefs @{ui}config file will be used.
  200.       Obviously, @{b}FontDT@{ub} support only @{b}OM_NEW@{ub} method.
  201. @endnode
  202. @node History "FontDT History"
  203.   @{b}@{u}History@{uu}@{ub}
  204.       Version 1.0 (22.4.95) - initial release.
  205.       Version 1.1 (8.7.95)
  206.     Improvements:
  207.  @{b}FOREGROUND@{ub} and @{b}BACKGROUND@{ub} configuration options added;
  208.  @{b}FONTNAME@{ub} can be used together with user text;
  209.  Included two icons for easier fonts viewing (one normal style, one
  210.   colour by Barry McConnell).
  211.  @{b}DPI@{ub} configuration option added;
  212.     Bug fixes:
  213.  Two hypothetical bugs fixed.
  214.  Fonts containing all ASCII characters weren't showed at all;
  215.  Fixed bug in outline fonts opening code;
  216.  No longer displays @{i}PROGDIR: @{ui}requester when used by @{i}IPrefs@{ui}.
  217. @endnode
  218. @node ToDo "To do in FontDT"
  219. @next ToDo
  220.   @{b}@{u}To do@{uu}@{ub}
  221.       @{b}FontDT@{ub} will not deal correctly with some of the less used fonts
  222.   formats. If you find that your font is not displayed correctly (this
  223.   particulary applies to color fonts) please send it to me so I can improve
  224.   the code.
  225.       Future versions may have ability to show fonts outside @{i}FONTS: @{ui}assign
  226.   and to show just specified size. The format of config files will be more
  227.   flexible.
  228. @endnode
  229. @node DataTypes "DataTypes Information"
  230. @prev DataTypes
  231. @next DataTypes
  232.   @{b}@{u}DataTypes@{uu}@{ub}
  233.       @{i}DataTypes @{ui}is an AmigaDOS subsystem (introduced in AmigaDOS 3.0) for
  234.   dealing with different types of files found on different machines (PC's,
  235.   Macs and Amigas). @{i}DataTypes @{ui}can be used for recognizing types of files
  236.   and interpreting informations in this files. An example of the latter is
  237.   @{i}MultiView@{ui}, which can show many types of data.
  238.       @{i}DataTypes @{ui}divide all files into the following main categories:
  239.       
  240.  @{i}syst @{ui}(System) - system files;
  241.       
  242.  @{i}text @{ui}(Text) - textual files;
  243.       
  244.  @{i}docu @{ui}(Document) - documents (spreadsheet data, text with
  245.         pictures etc.);
  246.       
  247.  @{i}soun @{ui}(Sound) - sound samples;
  248.       
  249.  @{i}inst @{ui}(Instrument) - musical instruments;
  250.       
  251.  @{i}musi @{ui}(Music) - songs;
  252.       
  253.  @{i}pict @{ui}(Picture) - graphics;
  254.       
  255.  @{i}anim @{ui}(Animation) - animations;
  256.       
  257.  @{i}movi @{ui}(Movie) - animation with sound.
  258.       Each category is further divided into subclasses. Each subclass
  259.   interprets one type of file, converting it to some universal format.
  260.   @{b}font.datatype@{ub} is an example of such subclass.
  261. @endnode
  262. @node Fonts "Amiga fonts"
  263. @prev Fonts
  264. @next Fonts
  265.   @{b}@{u}Amiga fonts@{uu}@{ub}
  266.       Amiga fonts come in three basic varieties:
  267.       
  268.  traditional @{i}bitmap fonts @{ui}are two-colour fonts. For each size there
  269.   exists separate file containing bitmap description of all characters
  270.   designed for that size.
  271.       
  272.  @{i}colour fonts @{ui}are stored like bitmap ones, but they may contain
  273.   additional informations about colour palette used when putting them on
  274.   screen.
  275.       
  276.  @{i}outline fonts @{ui}were introduced with release 2.04 of the operating
  277.   system. Each outline fonts contains vector description of its characters
  278.   which can be reproduced at any size - therefore they are scalable. From
  279.   release 3.0 of the operating system it is possible to use outline fonts
  280.   other than @{b}Compugraphic@{ub} (with additional software).
  281.       Each font has a description file (@{i}xxxxx.font@{ui}) containing informations
  282.   about available sizes and their properties. @{b}FontDT@{ub} operates on such files
  283.   @{u}only@{uu}.
  284. @endnode
  285. @node Author "About the Author"
  286. @prev Author
  287. @next Author
  288.   @{b}@{u}About the Author@{uu}@{ub}
  289.       @{b}FontDT@{ub} package was written by @{b}Michael Letowski@{ub}, who is a Software
  290.   Engineering student at Technical University of Wroclaw and has A1200.
  291.       If you have something to say me (questions, remarks, suggestions,
  292.   wishes, bug reports) please contact me (I like receiving mail!):
  293.     by E-Mail (preferred way):
  294.       @{b}letowski@ci-1.ci.pwr.wroc.pl@{ub}
  295.       @{b}pro37@ci3ux.ci.pwr.wroc.pl@{ub}
  296.     by normal mail:
  297.       @{b}Michal Letowski
  298.       Przyjazni 51/17
  299.       53-030 Wroclaw
  300.       POLAND@{ub}
  301.       You can get my other free software:
  302.    @{" MCommands " link MCommands.guide/main} - 7 useful AmigaDOS CLI commands
  303.       (@{i}Aminet://util/cli/MCommands-1.2.lha@{ui});
  304.    @{"    MCEd   " link MCEd.guide/main} - 8 great ARexx scripts for @{i}CygnusEd @{ui}users
  305.       (@{i}Aminet://text/edit/MCEd-1.2.lha@{ui});
  306.    @{"ClipHandler" link ClipHandler.guide/main} - easily exchange data between AmigaDOS and applications
  307.       (@{i}Aminet://util/misc/ClipHandl-1.0.lha@{ui});
  308.    @{"   MREKO   " link MREKO.guide/main} - DataType for viewing @{i}REKO @{ui}cardsets
  309.       (@{i}Aminet://util/dtype/MREKO-1.0.lha@{ui}).
  310. @endnode
  311. @node Index "FontDT Index"
  312. @prev Index
  313. @next Index
  314.   @{b}@{u}Index@{uu}@{ub}
  315.   @{"     Author     " link Author}
  316.   @{"  Configuration " link Configuration}
  317.   @{"Copyright notice" link Copyright}
  318.   @{"    DataTypes   " link DataTypes}
  319.   @{"      Fonts     " link Fonts}
  320.   @{"     History    " link History}
  321.   @{"  Installation  " link Installation}
  322.   @{"  Introduction  " link Introduction}
  323.   @{"      Notes     " link Notes}
  324.   @{"  Requirements  " link Requirements}
  325.   @{"      To do     " link ToDo}
  326. @endnode
  327.